home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / jkpro44.zip / JKPRO.DOC next >
Text File  |  1990-01-14  |  9KB  |  237 lines
  1.  
  2.  
  3.                    ╒════════════════════════════════════════╕ 
  4.                    │    ▓░▓░▓░▓░    J K P R O  ░▓░▓░▓░▓     │ 
  5.                    │               +++++++++++              │ 
  6.                    │  HELP !          v4.4          HELP !  │
  7.                    │                                        │ 
  8.                    │      CopyRight (1990) J.J.Kreyling     │ 
  9.                    ╘══════════ All Rights Reserved ═════════╛ 
  10.  
  11.                        ┌───────────────────────────┐          
  12.                        │ Note: Update list at END! │
  13.                        └───────────────────────────┘
  14.  
  15. JK Series Design:
  16. ─────────────────
  17. I am presently writing a number of utilities to be used with GT Comm. All of
  18. the programs will read data from a universal configuration file. The format 
  19. for this file is shown below. It MUST be in the directory pointed to by the 
  20. "GTPATH=" variable. The programs themselves may be placed ANYWHERE !
  21.  
  22.  
  23. Purpose:
  24. ────────
  25. The purpose of this program is to create the file directory listings 
  26. used by prodoor. It will read in the GT files.bbs and then output the 
  27. "DIR(x)" (where 'x' is directory number) files into the prodoor directory.
  28.  
  29.  
  30. Registration:
  31. ─────────────
  32. A CRC will be issued to turn-on the options such as color, 
  33. custom file description, user-defined error file path,etc. 
  34. See the jk.cnf description for full details.
  35. When registered, you will receive a CRC in which you will enter under 
  36. parameter "IP="
  37.  
  38. Registraton is $5.00  
  39.  
  40.  
  41. JK.cnf file format and examples:
  42. ────────────────────────────────
  43. Note: any entry with the <R> behind them are ONLY available if 
  44. Registered ! So Register Today !
  45.  
  46. ND=30                  'Number of GT download file directories
  47. NM=Un-Registered User  'User Name (Max. 25 chars)                    <R>
  48. IP=xxxx                'Registration code for JKpro                  <R>
  49. EP=c:                  'Alt-Path for error file to be sent           <R>
  50. PD=c:\prod             'Prodoor Dir (Full Path)
  51. HM=No                  'Turn popup help on/off -- Yes means Popup! 
  52. KF=No                  'Keep OLD jkpro.err file -- Yes or No         <R>
  53. CP=Enter custom file description here - MAX.=45 chars. (WYSIWYG)     <R>
  54.  
  55. ...........of course, remove ALL comments, etc from the file !
  56.  
  57.  
  58.  
  59. Command Line Options:
  60. ─────────────────────
  61. If used, will over-ride the jk.cnf file !
  62.  
  63. ┌────────────────────────────────[ Syntax Guide ]──────────────────────────────┐
  64. │Syntax: JKpro /Q  /H                                                          │
  65. │ /Qx/x/x      = Quick update of specified dir's only                          │
  66. │ /H           = Help ! I'm lost !                                             │
  67. └──────────────────────────────────────────────────────────────────────────────┘
  68.              Support BBS Data Line = (804) 357-0357  Call Anytime....           
  69.                300 - 19,200 BPS { HST }     N-8-1     ProDoor - 30              
  70.  
  71.  
  72.   ───────────────────────────────────────────────────────────────────────────
  73.                                   UPDATES:
  74.   ───────────────────────────────────────────────────────────────────────────
  75. ┌──────────┐
  76. │04/15/1989│
  77. └──────────┘
  78. Nothing - Just Released ! 
  79. Docs not much at this time, but all info is there, just no examples.
  80. If a real problem arises, please call the BBS for help of any sort !
  81.  
  82.  
  83. ┌──────────┐
  84. │06/04/1989│
  85. └──────────┘
  86. 1) When rewriting the date, I missed the correct column and it caused the
  87. new file search not to function at all ! {FIXED}
  88.  
  89. 2) Also, for those of you that use a utility to create the files.bbs that
  90. does not use leading zeroes, prodoor would also eror out ! Now when the
  91. DIR files are created, I'll insert the leading zero if not there. The GT
  92. files.bbs will NOT be altered whatsoever.
  93.  
  94. 3) Added a color NUMBER menu to the help switch for those that do not know the
  95. color numbers. For the help to pop up, type JKPRO /H <enter>
  96.  
  97. Sorry for the problems....
  98.  
  99.  
  100. ┌──────────┐
  101. │06/11/1989│
  102. └──────────┘
  103. 1) Support added for those who leave their comments field empty. JKpro
  104. would error out if this condition was encountered. It will now insert a
  105. message stating no desription is available and keep on a rolling !
  106.  
  107. 2) Another one for the files.bbs where the description is tooooo long to
  108. fit in the room allotted by PCB or ProDoor. JKpro will now WRAP the file
  109. to the next line as in PCB. No more truncated files listings. Neat, huh? 
  110. This one dedicated to Scott Swaine..Scott, No more manual editing for you. 
  111. This is just a small token for the work you have already done for PCB.
  112.                                                               Thanks !
  113.  
  114. 3) QUICK Mode now accessed with command line parameter " /Q ". The format
  115. is the same as with JKcbs (if you use it).
  116.  
  117.        JKpro /Q3/5/9/34   - This will ONLY update the DIR files whose
  118.                             numbers appear in the listing. In this case,
  119.                             #'s 3-5-9-34. Easy !
  120.  
  121. If you have the JK.cnf file set up and running, this is the ONLY switch
  122. you will ever really need to use in most cases.
  123.  
  124. 4) Screen has had a face lift...The directory listing is removed...a
  125. much cleaner looking screen.
  126.  
  127. 5) Added support for the JK.cnf file parameter " NH= ". This may be set
  128. to yes or no and will enable or disable the help file popping up when an
  129. error has occurred. This is done to implement running in a batch file.
  130.  
  131. ┌──────────┐
  132. │06/12/1989│
  133. └──────────┘
  134. 1) Error message display has been changed and now works like the help
  135. menu. If you specify HM=YES, then the error msg will stay on screen
  136. until a key is pressed. If NO, then the error will be logged to the
  137. JKpro.err file ONLY...For batch file operation.
  138.  
  139. 2) Missing description lines were still causing problems if no *space*
  140. followed the date. {FIXED}
  141.  
  142. 3) Added Date and Time Display....Big Deal, huh?
  143.  
  144. ┌──────────┐
  145. │06/18/1989│
  146. └──────────┘
  147. 1) Command line option /U has been removed.
  148.  
  149. 2) Added Custom Description option for files without descriptions. This 
  150. is a registered only option ! Max. lenght of desc. is 45 chars.
  151.    Parameter = "CD="
  152.  
  153. 3) Added User Defined path for the error log file to be written to.
  154.    Parameter = "EP="
  155.  
  156. 4) Problem existed if a path had a trailing backslash. They are now 
  157. trapped out.
  158.  
  159. 5) Many had file descriptions that had various things that were not 
  160. considered "normal" to the GT format. ALL of these should now be handled 
  161. properly and program will no longer abort if one of these conditions 
  162. exist. 
  163.         Some examples are:
  164.         ------------------
  165.         1) Date field had something other than a proper date in the 
  166.         format of xx-xx-xx. Now almost anything can be put into here. 
  167.         (Try this one Chet...)
  168.         
  169.         2) File names without ext's, such as the bullet files are now 
  170.         handled properly
  171.         
  172.         3) No descriptions at all - Standard description is now inserted 
  173.         and if registered, a custom msg will be used.
  174.         
  175. 6) Added parameter "KF=". Set to NO or YES. See the following paragraph 
  176. for details.
  177.  
  178. 7) Error file now holds the complete path/name of any file that is 
  179. missing a description. Beware...if you get lazy and run this program a 
  180. lot, this file can become rather large ! Delete it if you are finished 
  181. with it ! If Registered, you may specify to only keep the latest 
  182. statistics from the last run. Every time there will be a new file 
  183. created, so use it and if you do not feel like erasing it at that moment 
  184. and the jk.cnf parameter "KF=" is set to NO, then only the latest 
  185. version of the jkpro.err file will be kept !
  186.  
  187. ┌──────────┐
  188. │09/09/1989│
  189. └──────────┘
  190. 1) Parameter "CD=" is changed to "CP="
  191.  
  192. 2) Colors are now taken from your GT Setup.
  193.  
  194. 3) ALL command line parameters have been removed except for:
  195.  
  196.     /Q - QUICK MODE
  197.     /H - HELP
  198.     
  199. 4) Code size decreased - Speed increased
  200.  
  201. 5) Lists total megs converted to give you an idea of just 
  202.    what you have on your system.
  203.    
  204. ┌──────────┐
  205. │10/14/1989│
  206. └──────────┘
  207. 1) Added the parameter "MF=" to disable logging if you wish.
  208. To disable logging and speed operation, add this new parameter to the
  209. JK.cnf file. No = [No Logging] and [Yes = Logging]
  210.  
  211. ┌──────────┐
  212. │11/05/1989│
  213. └──────────┘
  214. 1) Added Support for 50 file directories !
  215.  
  216. ┌──────────┐
  217. │01/14/1990│
  218. └──────────┘
  219. 1) No biggy ! Had to correct CopyRight Spelling
  220.  
  221.  
  222. That's it for now...
  223.  
  224. Well, Give them a try, and if trouble exist, Just call ! or Send
  225. Netmail to Club PC BBS - 048/001
  226.  
  227.  
  228.  
  229.                                 Jim Kreyling
  230.                                 ------------  
  231.                                 Club PC BBS
  232.                                (804) 357-0357
  233.                               300 - 19,200 BPS
  234.                              1217 Crescent Drive
  235.                             Smithfield, Va. 23430
  236.  
  237.